<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Rating - schema.org</title>
    <meta name="description" content="Schema.org is a set of extensible schemas that enables webmasters to embed
    structured data on their web pages for use by search engines and other applications." />
    <link rel="stylesheet" type="text/css"
          href="/docs/schemaorg.css" />

    <link href="/docs/prettify.css" type="text/css"
          rel="stylesheet" />
    <script type="text/javascript" src="/docs/prettify.js">
    </script>
    <script type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.5.1/jquery.min.js"></script>

<script type="text/javascript">
      $(document).ready(function(){
        prettyPrint();
        setTimeout(function(){

  $(".atn:contains(itemscope), .atn:contains(itemtype), .atn:contains(itemprop), .atn:contains(itemid), .atn:contains(time), .atn:contains(datetime), .atn:contains(datetime), .tag:contains(time) ").addClass('new');
  $('.new + .pun + .atv').addClass('curl');

        }, 500);
        setTimeout(function(){

  $(".atn:contains(property), .atn:contains(typeof) ").addClass('new');
  $('.new + .pun + .atv').addClass('curl');

        }, 500);
        setTimeout(function() {
          $('.ds-selector-tabs .selectors a').click(function() {
            var $this = $(this);
            var $p = $this.parents('.ds-selector-tabs');
            $('.selected', $p).removeClass('selected');
            $this.addClass('selected');
            $('pre.' + $this.data('selects'), $p).addClass('selected');
          });
        }, 0);
      });
</script>

<style>

  .pln    { color: #444;    } /* plain text                 */
  .tag    { color: #515484; } /* div, span, a, etc          */
  .atn,
  .atv    { color: #314B17; } /* href, datetime             */
  .new    { color: #660003; } /* itemscope, itemtype, etc,. */
  .curl   { color: #080;    } /* new url                    */

  table.definition-table {
    border-spacing: 3px;
    border-collapse: separate;
  }

</style>

</head>
<body>
    <div id="container">
        <div id="intro">
            <div id="pageHeader">
              <div class="wrapper">
                <h1>schema.org</h1>

<div id="cse-search-form" style="width: 400px;"></div>

<script type="text/javascript" src="//www.google.com/jsapi"></script>
<script type="text/javascript">
  google.load('search', '1', {language : 'en', style : google.loader.themes.ESPRESSO});
  google.setOnLoadCallback(function() {
    var customSearchControl = new google.search.CustomSearchControl('013516846811604855281:nj5laplixaa');
    customSearchControl.setResultSetSize(google.search.Search.FILTERED_CSE_RESULTSET);
    var options = new google.search.DrawOptions();
    options.enableSearchboxOnly("/docs/search_results.html", null, false, '#');
    customSearchControl.draw('cse-search-form', options);
  }, true);
</script>


              </div>
            </div>
        </div>
    </div>

            <div id="selectionbar">
               <div class="wrapper">
                <ul>
                    <li >
                      <a href="docs/documents.html">Documentation</a></li>
                    <li class="activelink">
                      <a href="docs/schemas.html">Schemas</a></li>
                    <li >
                      <a href=".">Home</a></li>
                </ul>
                </div>

            </div>
        <div style="padding: 14px; float: right;" id="languagebox"></div>



  <div id="mainContent" vocab="http://schema.org/" typeof="rdfs:Class" resource="http://schema.org/Rating">
  <!-- no external mappings noted for this term. -->

<h1 class="page-title">
<a href="Thing">Thing</a> &gt; <a href="Intangible">Intangible</a> &gt; <span property="rdfs:label"><a href="Rating">Rating</a></span></h1> <div property="rdfs:comment">The rating of the video.</div>


<table class="definition-table">
        <thead>
  <tr><th>Property</th><th>Expected Type</th><th>Description</th>               
  </tr>
  </thead>

<thead class="supertype">
  <tr>
    <th class="supertype-name" colspan="3">Properties from <a href="Rating" property="rdfs:subClassOf">Rating</a></th>
  </tr>
</thead>

<tbody class="supertype">
  <tr typeof="rdfs:Property" resource="http://schema.org/bestRating">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="bestRating">bestRating</a></code>
    </th>
 <td class="prop-ect">
<a href="Number" property="rangeIncludes">Number</a>&nbsp; or <br/> <a href="Text" property="rangeIncludes">Text</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">The highest value allowed in this rating system. If bestRating is omitted, 5 is assumed.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/ratingValue">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="ratingValue">ratingValue</a></code>
    </th>
 <td class="prop-ect">
<a href="Text" property="rangeIncludes">Text</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">The rating for the content.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/worstRating">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="worstRating">worstRating</a></code>
    </th>
 <td class="prop-ect">
<a href="Number" property="rangeIncludes">Number</a>&nbsp; or <br/> <a href="Text" property="rangeIncludes">Text</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">The lowest value allowed in this rating system. If worstRating is omitted, 1 is assumed.</td></tr><thead class="supertype">
  <tr>
    <th class="supertype-name" colspan="3">Properties from <a href="Thing">Thing</a></th>
  </tr>
</thead>

<tbody class="supertype">
  <tr typeof="rdfs:Property" resource="http://schema.org/additionalType">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="additionalType">additionalType</a></code>
    </th>
 <td class="prop-ect">
<a href="URL" property="rangeIncludes">URL</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">An additional type for the item, typically used for adding more specific types from external vocabularies in microdata syntax. This is a relationship between something and a class that the thing is in. In RDFa syntax, it is better to use the native RDFa syntax - the 'typeof' attribute - for multiple types. Schema.org tools may have only weaker understanding of extra types, in particular those defined externally.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/alternateName">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="alternateName">alternateName</a></code>
    </th>
 <td class="prop-ect">
<a href="Text" property="rangeIncludes">Text</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">An alias for the item.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/description">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="description">description</a></code>
    </th>
 <td class="prop-ect">
<a href="Text" property="rangeIncludes">Text</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">A short description of the item.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/image">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="image">image</a></code>
    </th>
 <td class="prop-ect">
<a href="URL" property="rangeIncludes">URL</a>&nbsp; or <br/> <a href="ImageObject" property="rangeIncludes">ImageObject</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">An image of the item. This can be a <a href="http://schema.org/URL">URL</a> or a fully described <a href="http://schema.org/ImageObject">ImageObject</a>.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/name">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="name">name</a></code>
    </th>
 <td class="prop-ect">
<a href="Text" property="rangeIncludes">Text</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">The name of the item.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/potentialAction">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="potentialAction">potentialAction</a></code>
    </th>
 <td class="prop-ect">
<a href="Action" property="rangeIncludes">Action</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">Indicates a potential Action, which describes an idealized action in which this thing would play an 'object' role.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/sameAs">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="sameAs">sameAs</a></code>
    </th>
 <td class="prop-ect">
<a href="URL" property="rangeIncludes">URL</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">URL of a reference Web page that unambiguously indicates the item's identity. E.g. the URL of the item's Wikipedia page, Freebase page, or official website.</td></tr><tr typeof="rdfs:Property" resource="http://schema.org/url">
    
      <th class="prop-nam" scope="row">

<code property="rdfs:label"><a href="url">url</a></code>
    </th>
 <td class="prop-ect">
<a href="URL" property="rangeIncludes">URL</a>&nbsp;</td><td class="prop-desc" property="rdfs:comment">URL of the item.</td></tr></table>
<br/><br/>Instances of <a href="Rating">Rating</a> may appear as values for the following properties<br/><table class="definition-table">
        
  
<thead>
  <tr><th>Property</th><th>On Types</th><th>Description</th>               
  </tr>
</thead>

<tr>
<th class="prop-nam" scope="row">
 <code><a href="reviewRating">reviewRating</a></code>
</th>
 
<td class="prop-ect">
<a href="Review">Review</a>&nbsp;</td><td class="prop-desc">The rating given in this review. Note that reviews can themselves be rated. The <code>reviewRating</code> applies to rating given by the review. The <code>aggregateRating</code> property applies to the review itself, as a creative work. </td></tr></table>


</table>

<br/><b>More specific Types</b><li> <a href="AggregateRating">AggregateRating</a><br/><br/><b>Examples</b><br/><br/>

<div class='ds-selector-tabs ds-selector'>
  <div class='selectors'>
    <a value='original_html' data-selects='original_html' class='selected'>Without Markup</a>
    <a value='microdata' data-selects='microdata' class=''>Microdata</a>
    <a value='rdfa' data-selects='rdfa' class=''>RDFa</a>
    <a value='jsonld' data-selects='jsonld' class=''>JSON-LD</a>
</div>

<pre class="prettyprint lang-html linenums original_html selected">Kenmore White 17" Microwave
&lt;img src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' /&gt;
Rated 3.5/5 based on 11 customer reviews
$55.00
In stock
Product description:
0.7 cubic feet countertop microwave. Has six preset cooking categories and
 convenience features like Add-A-Minute and Child Lock.
Customer reviews:
Not a happy camper - by Ellie, April 1, 2011
1/5 stars
The lamp burned out and now I have to replace it.
 Value purchase - by Lucas, March 25, 2011
4/5 stars
Great microwave for the price. It is small and fits in my apartment.
...
</pre>

<pre class="prettyprint lang-html linenums microdata ">&lt;div itemscope itemtype="http://schema.org/Product"&gt;
  &lt;span itemprop="name"&gt;Kenmore White 17" Microwave&lt;/span&gt;
  &lt;img src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' /&gt;
  &lt;div itemprop="aggregateRating"
    itemscope itemtype="http://schema.org/AggregateRating"&gt;
   Rated &lt;span itemprop="ratingValue"&gt;3.5&lt;/span&gt;/5
   based on &lt;span itemprop="reviewCount"&gt;11&lt;/span&gt; customer reviews
  &lt;/div&gt;
  &lt;div itemprop="offers" itemscope itemtype="http://schema.org/Offer"&gt;
    &lt;!--price is 1000, a number, with locale-specific thousands separator
    and decimal mark, and the $ character is marked up with the
    machine-readable code "USD" --&gt;
    &lt;span itemprop="priceCurrency" content="USD"&gt;$&lt;/span&gt;&lt;span
          itemprop="price" content="1000.00"&gt;1,000.00&lt;/span&gt;
    &lt;link itemprop="availability" href="http://schema.org/InStock" /&gt;In stock
  &lt;/div&gt;
  Product description:
  &lt;span itemprop="description"&gt;0.7 cubic feet countertop microwave.
  Has six preset cooking categories and convenience features like
  Add-A-Minute and Child Lock.&lt;/span&gt;
  Customer reviews:
  &lt;div itemprop="review" itemscope itemtype="http://schema.org/Review"&gt;
    &lt;span itemprop="name"&gt;Not a happy camper&lt;/span&gt; -
    by &lt;span itemprop="author"&gt;Ellie&lt;/span&gt;,
    &lt;meta itemprop="datePublished" content="2011-04-01"&gt;April 1, 2011
    &lt;div itemprop="reviewRating" itemscope itemtype="http://schema.org/Rating"&gt;
      &lt;meta itemprop="worstRating" content = "1"&gt;
      &lt;span itemprop="ratingValue"&gt;1&lt;/span&gt;/
      &lt;span itemprop="bestRating"&gt;5&lt;/span&gt;stars
    &lt;/div&gt;
    &lt;span itemprop="description"&gt;The lamp burned out and now I have to replace
    it. &lt;/span&gt;
  &lt;/div&gt;
  &lt;div itemprop="review" itemscope itemtype="http://schema.org/Review"&gt;
    &lt;span itemprop="name"&gt;Value purchase&lt;/span&gt; -
    by &lt;span itemprop="author"&gt;Lucas&lt;/span&gt;,
    &lt;meta itemprop="datePublished" content="2011-03-25"&gt;March 25, 2011
    &lt;div itemprop="reviewRating" itemscope itemtype="http://schema.org/Rating"&gt;
      &lt;meta itemprop="worstRating" content = "1"/&gt;
      &lt;span itemprop="ratingValue"&gt;4&lt;/span&gt;/
      &lt;span itemprop="bestRating"&gt;5&lt;/span&gt;stars
    &lt;/div&gt;
    &lt;span itemprop="description"&gt;Great microwave for the price. It is small and
    fits in my apartment.&lt;/span&gt;
  &lt;/div&gt;
  ...
&lt;/div&gt;
</pre>

<pre class="prettyprint lang-html linenums rdfa ">&lt;div vocab="http://schema.org/" typeof="Product"&gt;
  &lt;span property="name"&gt;Kenmore White 17" Microwave&lt;/span&gt;
  &lt;img src="kenmore-microwave-17in.jpg" alt='Kenmore 17" Microwave' /&gt;
  &lt;div property="aggregateRating"
     typeof="AggregateRating"&gt;
   Rated &lt;span property="ratingValue"&gt;3.5&lt;/span&gt;/5
   based on &lt;span property="reviewCount"&gt;11&lt;/span&gt; customer reviews
  &lt;/div&gt;
  &lt;div property="offers"  typeof="Offer"&gt;
    &lt;!--price is 1000, a number, with locale-specific thousands separator
        and decimal mark, and the $ character is marked up with the
        machine-readable code "USD" --&gt;
    &lt;span property="priceCurrency" content="USD"&gt;$&lt;/span&gt;&lt;span
      property="price" content="1000.00"&gt;1,000.00&lt;/span&gt;
    &lt;link property="availability" href="http://schema.org/InStock" /&gt;In stock
  &lt;/div&gt;
  Product description:
  &lt;span property="description"&gt;0.7 cubic feet countertop microwave.
  Has six preset cooking categories and convenience features like
  Add-A-Minute and Child Lock.&lt;/span&gt;
  Customer reviews:
  &lt;div property="review"  typeof="Review"&gt;
    &lt;span property="name"&gt;Not a happy camper&lt;/span&gt; -
    by &lt;span property="author"&gt;Ellie&lt;/span&gt;,
    &lt;meta property="datePublished" content="2011-04-01"&gt;April 1, 2011
    &lt;div property="reviewRating"  typeof="Rating"&gt;
      &lt;meta property="worstRating" content = "1"&gt;
      &lt;span property="ratingValue"&gt;1&lt;/span&gt;/
      &lt;span property="bestRating"&gt;5&lt;/span&gt;stars
    &lt;/div&gt;
    &lt;span property="description"&gt;The lamp burned out and now I have to replace
    it. &lt;/span&gt;
  &lt;/div&gt;
  &lt;div property="review"  typeof="Review"&gt;
    &lt;span property="name"&gt;Value purchase&lt;/span&gt; -
    by &lt;span property="author"&gt;Lucas&lt;/span&gt;,
    &lt;meta property="datePublished" content="2011-03-25"&gt;March 25, 2011
    &lt;div property="reviewRating"  typeof="Rating"&gt;
      &lt;meta property="worstRating" content = "1"/&gt;
      &lt;span property="ratingValue"&gt;4&lt;/span&gt;/
      &lt;span property="bestRating"&gt;5&lt;/span&gt;stars
    &lt;/div&gt;
    &lt;span property="description"&gt;Great microwave for the price. It is small and
    fits in my apartment.&lt;/span&gt;
  &lt;/div&gt;
  ...
&lt;/div&gt;
</pre>

<pre class="prettyprint lang-html linenums jsonld ">&lt;script type="application/ld+json"&gt;
{
  "@context": "http://schema.org",
  "@type": "Product",
  "aggregateRating": {
    "@type": "AggregateRating",
    "ratingValue": "3.5",
    "reviewCount": "11"
  },
  "description": "0.7 cubic feet countertop microwave. Has six preset cooking categories and convenience features like Add-A-Minute and Child Lock.",
  "name": "Kenmore White 17\" Microwave",
  "offers": {
    "@type": "Offer",
    "availability": "http://schema.org/InStock",
    "price": "55.00",
    "priceCurrency": "USD"
  },
  "review": [
    {
      "@type": "Review",
      "author": "Ellie",
      "datePublished": "2011-04-01",
      "description": "The lamp burned out and now I have to replace it.",
      "name": "Not a happy camper",
      "reviewRating": {
        "@type": "Rating",
        "bestRating": "5",
        "ratingValue": "1",
        "worstRating": "1"
      }
    },
    {
      "@type": "Review",
      "author": "Lucas",
      "datePublished": "2011-03-25",
      "description": "Great microwave for the price. It is small and fits in my apartment.",
      "name": "Value purchase",
      "reviewRating": {
        "@type": "Rating",
        "bestRating": "5",
        "ratingValue": "4",
        "worstRating": "1"
      }
    }
  ]
}
&lt;/script&gt;
</pre>

</div>

<p class="version"><b>Schema Version 1.91</b></p>

<script>(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
	  (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
	  m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
	  })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
	  ga('create', 'UA-52672119-1', 'auto');ga('send', 'pageview');</script> 

</div>
</body>
</html>